DATA OUTPUT 4 

Program J3-03. 
GENERAL PRECiSIOM, mC. / COMMERCIAL COMPUTER DIVISION 



ABSTRACT 

"Data Output 4," program" J3-03. 0, is an RPC-4000 program which will 
print or punch the contents of groups of consecutive memory locations 
assuming all numbers to be integers. The number of locations to be 
printed, the field width, the number of decimal places, and carriage 
returns, if desired, are specified by code words. The output word may 
consist of leading spaces, a decimal point, a sign, and a maximum of 
nine digits. 

"Data Output 2" will continue to process and execute code words until an 
exit is encountered, whereupon it will transfer to the exit instruction 
specified by the source program. 



STORAGE 



MAIN MEMORY 31EQUIRED 



RECIRCULATING SECTORS USED 



INDEX REGISTER 



191 sectors, including region 
assignment. 



0, 1, 2, 3, and 4 



Used in calling sequence and during 
execution. Contents prior to entry 
is not restored upon exit. 



UPPER AND LOWER ACCUMULATORS 

The Lower Accumulator contains the instruction to which "Data Output 2" 
will exit after completing the designated output. 

The contents of the Upper Accumulator is immaterial. 

The contents of either accumulator is not restored upon exit to the 
source program. The Lower Accumulator must be in One-Word Mode at 
time of entry to "Data Output 4," and will be left in this mode at 
exit. 
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IXIINTED IN U.S.A. 



DATA OUTPUT 4 



INPUT 

The input variables for "Data Output 4" are as follows: 

1. The list of control codes. 

2. The data to be output. 

The control codes define the output format in the following manner: 

Bits 0-4 Order Portion of the Word - specifies the number of 
locations to be output under the control of a given 
code word. The number may range from to 31. 

Bits 5-17 Data-Address Portion of the Word - contains the ad- 
dress of the first location to be printed. 

Bits 18-24 Next -Address Track - specifies the total field width 
including any leading spaces, digits, sign, and pos- 
sible decimal point. The maximum field width is 63... 
The minimum width varies in accordance with the fol- 
lowing rules : 

a. The minimum field for an integer print with no deci- 
mal point is 1 plus the number of digits to be print- 
ed. This allows for the sign position. 

b. The minimum field for a number with a decimal point; 
is 2 plus the number of digits to be printed. ; 

It is assumed that at least one digit will be printed in 
all cases. 

Bits 25-30 Next-Address Sector - contains the number of decimal 
places desired, which may range from 00 to 09. 

Bit 31 Index Bit ^ the presence of an index bit will cause the 
subroutine to exit to the source program after output of 
the location(s) specified in the indexed code word. 
"Data Output 4" will continue to process sequential code 
words and execute output as specified until an indexed 
code word is encountered. 
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INPUT (Cont. ) , 

Special Types of Code Words 

a. Carriage returns may be inserted when desired during output, with- 
out exiting from "Data Output 4." This may be accomplished'by the 
use of a code word consisting of the configuration HEX*8000*0* 
(see "EXAMPLE"). This code word may not be indexed and is there- 
fore unsuitable as an exit instruction. 

b. Code words which contain a zero in the Order portion of the word 
may be used. They will be examined and then skipped since they 
indicate no locations to be output. This feature enables the 
programmer to modify a set of code words in order to omit por- 
tions of the set without having to rearrange the code words in 
sequential order. Either the Order portion of the word or the 
entire location may be set to zero in order to skip the output 
it indicates. This type of code word may be indexed, however 
care must be taken not to "zero" the entire word if it is to 
signify an exit code. 

When control is transferred to the subject program, the Index Register 
must contain the address of the first code word. The code word(s) may 
be anywhere in memory. If more than one is used, they must be in 
sequential locations. For example, the first control code, Ci , might 
be in 1300, then Ci+i would be in 1301, etc. The address 130o'would 
be in the Index Register. 



CALLING SEQUENCE 

Location Command Data-Address Next-Addre ss 

A LDX Ci B 

B RAL EXIT ]0141 

EXIT etc. -^ 

In the calling sequence illustrated, Ci is the address of the first 
control code word, and EXIT is the location of the exit instruction to 
which "Data Output 4" will transfer when returning control to the source 
program. The entry location of "Data Output 4" is ]0141. 
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GALLING SEQUENCE (Cont.) 

It is not necessary for the calling sequence to be written in the form 
illustrated. Any sequence of operations iiiay be used which places the 
address of the first control word in the Index Register and the exit 
instruction in the Lower Accumulator before transferring to the subject 
program. 



OUTPUT 

Output is exact. The specified locations will be output with leading 
zeros suppressed and will be followed by a sign position. A positive 
word is indicated by a trailing space, a negative word by a minus sign. 
A word equal to zero will be output with the integer portion suppress- 
ed, and with a trailing space to indicate a positive number. 



ROAR-DEPENDENT FEATURES 



ROAR HEADER TAG REQUIRED 



COMMUNICATION SYMBOLS 



Symbol 
]0141 



None. The program is preceded by 
the pseudo-instruction HED. 



Definition 

Entry point and first instruction 
executed. ]0141 is not the first 
instruction on the program tape and 
should be equated with the desired 
location. 



REGIONS ASSIGNED 

Symbol 
A 



Number of Sectors 
9 
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OPERATING PROCEDURE 



1. OPERATING TIME 



Operating time depends upon and varies with th6 magnitude of the 
field width. Internally, one character is generated per drum 
revolution. 



2. ACCURACY 



LOADING PROCEDURE 



Output is exact. 



The program is assembled by ROAR III , 
program H2-01.2, and requires a nine 
sector region assignment for region A. 



4. INPUT/OUTPUT DEVICES REQUIRED 

No input device is needed during execution. The output device 
may be selected manually or by the source program. 



5. SENSE SWITCH OPTIONS 



6 . INFORMATION PRINTOUTS 



None. 



None, except for error indications. 
(See "PROGRAM STOPS AND ERROR INDI- 
CATIONS.") 



PROGRAM STOPS AND ERROR INDICATIONS 

Two types of errors may occur during program execution: 

a. Incorrect code word . A printout and self-addressed halt will 
occur if a code word is entered which specifies too small a 
field width to accommodate the printing of the indicated 
digits. For example, if a field width of 10 spaces is indi- 
cated and the printing of 9 decimal places is called for, the 
code word violates the specification that, if a decimal point 
is to be output, the total field width must be at least 2 
greater than the number of digits to be output. The printout 
for this error consists of the code word with the field width 
overtyped with slashes: 

03 1452 ;f0O9 
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OPERATING PROCEDURE 

7. PROGRAM STOPS AND ERROR INDICATIONS (Cont.) 

a. The ensuing halt is non-recoverable during execution. The 
error should be corrected and the program re-entered. 

b. Incorrect data word . If the number of digits in a data word 
exceeds the number permitted for the specified field width, 
the field width will be crossed out by x's, and the program 
will continue. This type of error would occur if, for example, 

, a code word were input which specified a field width of 7 and 
no decimal places, and more than six digits were entered for 
printing, and might appear as: 

06 4230 XOO 

Because of the nature of this error, the program will not 
halt. 



8. ENTRANCE TO PROGRAM 

This program is entered at symbolic location ]0141 by coding a 
. calling sequence in a source program. 

9. OPERATION OF PROGRAM 

One set of code words will be processed and the specified data 
will be output on the selected device each time the program is 
called. Termination of any set of code words is indicated by 
indexiag the terminal word in the set. 

10. EXIT FROM PROGRAM 

An exit instruction must be provided in the calling sequence. 
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EXAMPLE 

An example of the calling sequence and control codes may be as follows: 
Location Command Data-Address Next-Address 



A 


LDX 


Ci 


B 


B 


RAL 


EXIT 


30141 


EXIT 

• 


Etc. 






• 

Ci: 


HEX 


8000 





Ci+i 


03 


3600 


1200 


Ci+2 


HEX 


8000 





Ci+3 


X06 


5604 


904 



The instruction in location A stores the address C^ in the Index Reg- 
ister. The instruction in location B places the exit instruction in 
the Lower Accumulator and transfers control to "Data Output 4." C^ 
contains a code word which specifies a carriage return. C^+i indicates 
that 3 sequentially-stored words will be output, beginning with the 
one in 3600, using a field width of 12 and having no decimal places. 
Ci+2 specifies a carriage return. Ci+3 indicates that 6 sequentially- 
stored words will be output, beginning with the one in location 5604, 
using a field width of 9 and having 4 decimal places. Because the in- 
struction in location Ci+3 is indexed, "Data Output 4" will transfer to 
EXIT after the word in location 5609 has been output. 



COIVMENTS 

"Data Output 4" requires 2 tracks and 63 sectors of memory. One Sector 
is left available for the printing of a stop code at the end of each 
output word, if desired. If the output data is to be used as input to 
any program, the printing of the stop code will render the output com- 
pletely compatible with Data Input 3 , program J2-03.0, for reading back 
into the RPC-4000. The following change should be made in the symbolic 
program to provide for the printing of a stop code: 

Location STP should contain *PRD*899***. The original contents of 
location STP (*RAU*STR1***) should be the next instruction. TTiis 
leaves the program undisturbed except for the changed location. 
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SUMMARY 

ENTRY REQUIREMENTS 

Upper Accumulator 
Lower Accumulator 
Index Register 



SYMBOLIC ENTRY 
]0141 



REGION ASSIGNMENT 



RECIRCULATING SECTORS USED 



INDEX REGISTER USED BY PROGRAM 



EXIT CONDITIONS 



Upper Accumulator 
Lower Accumulator 
Index Register 



MANDATORY ROAR I NPUT CODES 



immaterial. 

Exit instruction. 

Address of first code word. 



Entry point and location of first 
instruction to be executed. 



A (9 sectors) 



0, 1, 2,\3, and 4. 



Yes 



Unpredictable. 
Unpredictable. 
Unpredictable. 



None. 
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FLOW CHART 




STORE EXIT 

INSTRUCTION 

IN LOCATION EXIT. 



eOOE WORD 
TO UPPER 



IS 

CODE WORB 

A CARRIAGE 

^RETURi 



JTES 




PRINT C.R., 
INCREMENT 
CODE WORD 
ADDRESS. 



<^ CODE WORD ^ 
^>s...,_^INOEXED^,-'^ 


m-^ 


SET LOCATION 
STOP NEGATIVE. 


NO 




e 


INITIALIZE FLAG. 
INCREMENT, CODE 
WORD ADDRESS, 
AND STORE. 











ABC a K" 




SET INTEGER 

COUNTER 

NEGATIVE 



STORE NO. INTEGERS 
TO PRINT IN ■ 
COUNTER. 



YES^ 




►f STP I j 




SET UP MULTIPLY 
TO NORMALIZE. 



STORE LOCATION 
OF NUMBER TO 
PRINT. 



EXTRACT AND 
STORE FIELD 
WIDTH. 



SET DECIMAL 

COUNTER 

NEGATIVE. 



EXTRACT AND 
STORE NO. OF 
DECIMAL POINTS. 




SET LEADING 

SPACE 

COUNTER. 



9 of 11 



DATA OUTPUT 4 



FLOW CHART 




ABC 2 



REPEATED 
MULTIPLY TO 
NORMALIZE 
NUMBER. 



NUMBER TO 
UPPER. - 



DIVIDE BY 
108 ©28 AND 
ROUND. 



YES 



NO. INTEGER 
DIGITS TO 
PRINT INTO 
COUNTER. 



NUMBER TO PRINT 
INTO UPPER. ■ 
STORE IN SIGN 
LOCATION. 




^ YES , 



YES 







COMPLEMENT 


Ves • 


NUMBER. 


■>4 







JPMt COUHTCIt 


^^ 




\ 


NO 






^ 


1 








PRINT 




DECREMENT 


SP 


ACE 




COUN 


TER 



& 



PRINT 

FIRST 

DIGIT. 




SET FLAG 
NEGATIVE 
PRINT DEC. 
POINT. 



EXTRACT 

FIRST 

DIGIT. 



DECREMENT 
COUNTER 



MULTIPLY TO 
GET NEXT 
DIGIT. 




HjO^^-^COUNTER 
EQUAL ZERO 



YES 



NO. DEC. 
DIGITS TO 
PRINT ,'NTO 
COUNTER. 





' 


YES 

■ 








4 


I 1 


PRINT A 




MULTIPLY TO 
GET NEXT 
DIGIT TO 
PRINT. 


DECREMENT 


SPAC 


:e. 






cdu^ 


ITER : 
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FLOW CHART 




TEST 




NO 



NO. DECIMAL 
PLACES TO 
PRT—» COUNTER 



SET FLAG 

NEa, PRINT 

DECIMAL POINT 




PRU 



SET FLAG 
TO ZERO 



PRINT A SPACE. 




YES 



PRINT A MINUS 



DECREMENT 

COUNTER OF 

LOC. TO PRINT 



INCREMENT 

ADD. OF LOC. 

TO BE PRINTED. 




NO 





YES , 
-*■! STP I 



'STOP 
-•< LOCATION 
^NEG, 




NO. 



ADO. NEXT 

CODE WORD 

INTO INDEX. 




& 



PRINT SLASHES 

ACROSS 
FIELD WIDTH 




e 



PRINT Xs 

ACROSS 

FIELD WIDTH 




11 of 11 



